home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / utility / 516 / orctoolb / tools1.doc < prev    next >
Encoding:
Text File  |  1991-03-08  |  5.3 KB  |  128 lines
  1.             Orc's collection of tiny-little
  2.             utilities of limited value unless
  3.             you run your ST via a shell in
  4.             the auto folder. Part 1
  5.  
  6.     These programs are released to the public domain.  You may do anything
  7.     you wish to them or with them.  If you modify one of the programs to
  8.     make it more useful, please release your changes to the public domain
  9.     as well.
  10.  
  11. BLACK: turn a monochrome screen black/white
  12.     Usage: black   - turn the monochrome screen black.
  13.        black x - turn the monochrome screen white.
  14.  
  15.     Black diddles the pallette settings for the console on a ST; it's behavior
  16.     with a colour monitor is probably not what you'd want to see.
  17.  
  18. BLIT: turns the blitter on or off (on the mega)
  19.     Usage: blit   - turns the blitter on
  20.        blit x - turns the blitter off
  21.  
  22. BOMBS: see what shrooms or error codes mean
  23.     Usage: bombs [shroom-count or error code]
  24.  
  25.     When a program blows up with a collection of shrooms, you can find out
  26.     what system error that is by doing "bombs <#shrooms>".  If the program
  27.     has problems and complains about negative error statuses, you can find
  28.     out what those mean by doing "bombs <error-status>"
  29.  
  30. CHMOD: changes file permissions.
  31.     Usage: chmod +[mode] file .. - adds modes to the file permissions.
  32.        chmod -[mode] file .. - takes modes away from the file permissions.
  33.        chmod [mode] file ..  - sets file permissions to modes.
  34.  
  35.     The modes are:
  36.         w - file writability.
  37.         s - the system bit.
  38.         h - the hidden bit.
  39.         a - the archive bit.
  40.  
  41.     Bugs:  The writability bit doesn't really work.  You can make a file
  42.        writable, but it's not possible to make a file readonly.
  43.  
  44. COPYTO: copy files to the ramdisk
  45.     Usage: copyto [-q] device:
  46.        copyto
  47.  
  48.     Copyto copies files to a filesystem (usually a ramdisk); it's useful
  49.     during bootup to load a ramdisk.  Copyto will not copy over files
  50.     that already exist (so if you have a persistant ramdisk, copyto won't
  51.     waste time recopying files.) If you specify a device on the commandline
  52.     (say, in the startup script of your shell), copyto expects to recieve
  53.     a list of files on its standard input. If you don't specify a device,
  54.     copyto will read the file COPYTO.DAT from your auto directory that
  55.     contains the device of the ramdisk, options information, then a list
  56.     of files to copy to it.  
  57.  
  58.     COPYTO.DAT contains one header line: this line has the keyword "ramdisk",
  59.     the device, then options.  If you are setting up to copy files \bin\vi.ttp,
  60.     \bin\tsh.ttp, and \bin\cc.ttp to your ramdisk e:, your COPYTO.DAT would
  61.     look like:
  62.         ramdisk e:/quiet
  63.         \bin\vi.ttp
  64.         \bin\tsh.ttp
  65.         \bin\cc.ttp
  66.  
  67.     Currently, the only option is /QUIET (-q from the commandline) ; normally,
  68.     copyto will display the names of the files as it is copying, but this
  69.     turns all output off except error output.
  70.  
  71. DF: shows freespace on filesystems
  72.     Usage: df [-t] [filesystem ..]
  73.  
  74.     If you give it the names of filesystems, df will tell you how much room
  75.     is available and how much is there, in K, of the filesystems.  If you
  76.     don't give df any arguments, it will give you statistics on every
  77.     filesystem you have (if you only have one floppy, it won't give you
  78.     statistics on the imaginary other floppy, though...)
  79.     The -t flags gives you a total of available + existing space for all of
  80.     the filesystems listed.
  81.  
  82. DUMP: does an IBM mainframe-style hex dump of a file
  83.     Usage: dump file ..
  84.  
  85.     Dump produces output of lines like
  86.  
  87.     address|hex contents of 16 bytes|character contents of 16 bytes|
  88.  
  89.     If you're dumping more than one file, dump will generate a small header
  90.     before each file.
  91.  
  92. DU: show disk usages in files/directories
  93.     Usage: du [-s] path ..
  94.  
  95.     Du will show you the how much room the directories or files are using,
  96.     in K-bytes. Normally, when du finds subdirectories, it will list the
  97.     space taken by them; the -s flag just gives the space of the things
  98.     you gave it as arguments.
  99.  
  100. MORE: a stupid terminal-dependant paginator
  101.     Usage: more [files]
  102.  
  103.     More cats files to stdout, pausing every 25 lines so that the user can
  104.     read the file.  When paused, the user can do the following things:
  105.         [return]  - displays one more line of the file
  106.         [space]   - displays one more page (25 lines) of the file
  107.         control-D - displays the next half page of the file.
  108.         Q,q       - quits more and returns to the shell or desktop
  109.         N         - goes to the next file, if there are any more.
  110.  
  111. SLICE: cuts a file up into easy-to-manage pieces
  112.     Usage: slice [-approximate size] file
  113.  
  114.     Slice cuts textfiles up into small easy-to-digest chunks.  When cutting
  115.     a file up, slice will write the bits to files with the suffix .1, .2, ..
  116.     and so on, replacing any existing suffix on the file in the process.
  117.  
  118. UNVERIFY: turns floppy-disk verification on/off
  119.     Usage: unverify   - turns floppy disk verification off (fast writing)
  120.        unverify x - turns floppy disk verification on (slow writing)
  121.  
  122. WHERE: finds a program in your PATH
  123.     Usage: where program ..
  124.  
  125.     Where tells you of every instance of program in your path; it will provide
  126.     suffixes if you don't (it knows about .app, .prg, .tos, and .ttp.) If it
  127.     can't find a given program, it will stay mum about it.
  128.